home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 April / macformat-023.iso / Shareware City / Utilities / JCONV-DD ver.1.8.1 ƒ / *Must read this to use* next >
Encoding:
Text File  |  1994-12-04  |  13.2 KB  |  392 lines  |  [TEXT/ttxt]
  1. JCONV-DD -- a JIS<->SJIS<->EUC converter
  2. ========================================
  3. FILE: JCONV-DD
  4. ver.: 1.8.1E(FAT)
  5. Type: Application
  6. Author: Natsu Sakimura
  7. Date: 1994.12.4
  8. System Requirement: System 7.0 or later
  9. Distribution: Donateware (see Asking your favour: 
  10.               section below for terms and conditions) 
  11.  
  12. *** This document is formatted in SE-TEXT format. ***
  13. *** You can use EasyView for more convenient browsing ***
  14.  
  15.     =================
  16.     TABLE OF CONTENTS
  17.     =================
  18. Conditions for the use of JCONV-DD
  19. Description:
  20. New In This Version:
  21. Usage:
  22. Result:
  23. Caution:
  24. Known Bugs:
  25. Disclaimer:
  26. Contact address:
  27. Distribution
  28. Notes:
  29. Acknowledgement:
  30. Asking your favour:
  31. Version History:
  32. Future Directions:
  33. Miscellaneous:
  34. Other utilities from the same author
  35.  
  36. Conditions for the use of JCONV-DD
  37. ----------------------------------
  38.     1. YOU MUST READ THIS DOCUMENT THOROUGHLY. 
  39.     2. SEND IN THE "User Registration" WHEN YOU DECIDE TO 
  40.        KEEP JCONV-DD. 
  41.     
  42. Description:
  43. ------------
  44.     JCONV-DD is a drag & drop application which performs 
  45.     the conversion of JIS, SJIS and EUC files. It 
  46.     auto-detects the encoding scheme of the file which was 
  47.     dropped.
  48.     JCONV-DD allows to set the default output code and EOL 
  49.     characters for each of New-JIS, Shift-JIS, EUC and
  50.     ASCII input files so that users do not need to specify 
  51.     neither input nor output code nor the EOL characters 
  52.     once the default has been set. For other features, 
  53.     please refer to the "Feature Set" file. 
  54.  
  55. New In This Version:
  56. --------------------
  57.     Finally! It is a FAT binary application. 
  58.     
  59. Usage:
  60. ------
  61.  *************************************************************
  62.  **    Before start using JCONV-DD version 1.8.1, users are    **
  63.  **    strongly recommended to set up the default behavior for ** 
  64.  **    the JCONV-DD.                                           **
  65.  *************************************************************
  66.     
  67.     To do so, just double click the JCONV-DD icon while 
  68.     pressing control key down until a dialog box appears. 
  69.     In the dialog box, you can set the default output 
  70.     code for each of JIS, SJIS, and EUC files. You can 
  71.     also set the EOL characters and creators to use in 
  72.     the output file. 
  73.     
  74.     From version 1.6.3, you are now able to choose between 
  75.     ESC(B and ESC(J as the so called "Kanji-Out" string in 
  76.     the preference dialog. 
  77.     
  78.     Please note that the EOL characters and the file 
  79.     creator depends upon the input file's code. This 
  80.     specification may be arguable, but this seems to 
  81.     be the best compromise to me at the moment. 
  82.     
  83.     The default setting at the time of shipping is:
  84.     ---------------------------------------
  85.     Input    Output      EOL     creator
  86.     ---------------------------------------
  87.     JIS      Shift-JIS    CR      Edt7
  88.     SJIS    New-JIS     LF      CRLF
  89.     EUC     Shift-JIS    CR      Edt7
  90.     ---------------------------------------
  91.     
  92.     Other creators I recommend is mdos for EOL==CRLF. 
  93.     As long as you have Apple file exchange, you will 
  94.     get the proper icon for mdos. 
  95.     
  96.     Once you have done the setup, just drag & drop one or more 
  97.     text files/folders onto JCONV-DD. JCONV-DD will automatically 
  98.     detect the input code, then converts the file according to 
  99.     the rule you have set in the preference dialog. 
  100.     
  101.     To override the default behavior, press COMMAND_KEY while 
  102.     dropping the files. A dialog comes up and through it, 
  103.     you can set up the input and output code as you desire.
  104.     
  105.     You can also change the output file's code by pressing one of 
  106.     the modifier keys.
  107.     
  108.     ----------- --------------------------
  109.         Key         Output
  110.     ----------- --------------------------
  111.     SHIFT_KEY    SHIFT-JIS
  112.     OPTION_KEY   EUC
  113.     SPACE_KEY    New-JIS
  114.     COMMAND_KEY  Specify through dialog
  115.     CONTROL_KEY  Setup the preference**
  116.     ----------- --------------------------
  117.     
  118.  ** I strongly recommend you to setup the preference before you 
  119.     start using JCONV-DD. It will save a lot of time later.
  120.     
  121.     You must continue pressing the modifier key until the conversion 
  122.     of the first file begin. (All the other files will be converted 
  123.     to the same code as the first file.)
  124.     
  125.     You can also open the application and select the files from 
  126.     Standard File dialog, but it doesn't make much sense, 
  127.     does it? The modifier key strategy also works here.
  128.  
  129. Result:
  130. -------
  131.     File with the desired encoding: Default is New-JIS.
  132.     The name of the output file will have the extension 
  133.     showing its code. e.g., if the original file was 
  134.     myfile.txt, then output will be something like 
  135.      myfile.new  -- New JIS
  136.      myfile.sjs  -- Shift JIS
  137.      myfile.euc  -- EUC.
  138.      myfile.old  -- Old-JIS
  139.      myfile.nec  -- NEC-JIS
  140.      myfile.rem  -- JIS without ESC code
  141.     
  142.     If you select Check Code Only mode, JCONV-DD will display 
  143.     the file's code.
  144.     
  145. Caution:
  146. --------
  147.     It has not been tested much.
  148.     *** IT IS NOT COMPATIBLE WITH SYSTEMS PRIOR TO SYSTEM 7.0 ***
  149.  
  150. Known Bugs:
  151. -----------
  152.      If you drop a folder onto JCONV-DD ver.1.8, ALL the files 
  153.      will be processed, including applications!
  154.      
  155.      If you drop too many files at once, it might hung up. 
  156.      This will not happen if the files are in a folder, and 
  157.      the folder is dropped onto JCONV-DD.  
  158.  
  159. Disclaimer:
  160. ---------- 
  161.     THE PROGRAMME IS PROVIDED AS IS. ABSOLUTELY NO RESPONSIBILITY 
  162.     WILL BE TAKEN BY THE AUTHOR FOR WHATEVER THE CONSEQUENCE OF 
  163.     THIS APPLICATION.
  164.  
  165. Contact address:
  166. ----------------
  167.     Please e-mail any suggestions to:
  168.         n-sakimura@nri.co.jp 
  169.  
  170. Distribution
  171. ------------
  172.     You can freely redistribute this package provided you do so in 
  173.     the original packaging, i.e., don't change any file in the 
  174.     package. You must not charge any money for the redistribution 
  175.     except for the nominal charge for the disk, etc. 
  176.  
  177.     All the files are copyrighted and not in the public domain:
  178.     It is a _DoanteWare_(see asking your favour section for details)! 
  179.  
  180. Notes:
  181. ------ 
  182.     This version of JCONV-DD implements subset of jconv ver.3.0 
  183.     by Ken Lunde. I wrote this because, from time to time, I 
  184.     had to convert between sjis and jis files. I wanted to do it 
  185.     without much interaction. I thought a drag & drop with only 
  186.     a few options will be nice. The reason for the public release 
  187.     was to help the people who has the similar needs and to 
  188.     ask your favour to donate if you have some extra monay to 
  189.     the people in needs. 
  190.  
  191.     The features dropped from jconv ver.3.0 are:
  192.     i. JIS/EUC/SJIS table
  193.     ii. verbose mode
  194.     
  195.     As of version 1.7.1, new improved Kanji Code detection 
  196.     algorithm is used. As a risult of it, it can now differentiate 
  197.     between EUC and SJIS with hankaku katakana in many cases. 
  198.         
  199. Acknowledgement:
  200. ----------------
  201.     I would like to thank Mr.Ken Lunde for making the source code  
  202.     of jconv freely available. Also, I would like to thank Mr.Troy 
  203.     Anderson for supplying "File Dropper" application shell 
  204.     without any license fee. The folder icon was created by 
  205.     Mr.Fumio Rokkaku. 
  206.  
  207. Asking your favour:
  208. -------------------
  209.     If you liked it and decided to use it, please make 
  210.     donations to an organization like UNHCR or "Medicines 
  211.     sans Frontieres" to help peaople in needs. 
  212.     
  213.     You can do it in 4 ways. 
  214.     
  215.     1) Find the organization near your place and donate. 
  216.        *** In this case, please send me the name and 
  217.        address of the organization to me. I am trying to 
  218.        compile a list of such organizations so that 
  219.        I can help people to get contact with these 
  220.        organizations easier. ( PLEASE STATE EXPLICITLY 
  221.        WHAT THE ORGANIZATION IS FOR!)
  222.     
  223.     2) Donate to the organizations in the attached list 
  224.        and send me to which organization you have donated 
  225.        (with or without amount. I believe your honesty.) 
  226.        
  227.     3) Send cheque or money order to me. Then, it will 
  228.        be forwarded to MSF. 
  229.        
  230.     4) If you are too poor to donate, then you can provide 
  231.        me with the name/address/phone number of a 
  232.        charitable organization of your area. 
  233.  
  234.     If you send in the "User Registration," then you will be 
  235.     a registered user for 1 year from the registration date. 
  236.     I will try to send the following to the internet connected 
  237.     registered users.  
  238.      
  239.       1) Bug reports
  240.       2) Notice of new version release.
  241.     
  242.     My address is: 
  243.     
  244.     Nat Sakimura
  245.     Nishi 3-7-13-201, Kunitachi, 
  246.     Tokyo 186, JAPAN
  247.     
  248.     E-mail: n-sakimura@nri.co.jp
  249.  
  250. Version History:
  251. ----------------
  252. 0.2b    The first release [1993.08.26].
  253. 1.3     The second release [1993.08.31]. New features:
  254.         • Added command mode to specify 
  255.        (1) Input Code [New-JIS, Old-JIS, NEC-JIS, EUC, Shift-JIS]
  256.        (2) Output Code [New-JIS, Old-JIS, NEC-JIS, EUC, Shift-JIS]
  257.        (3) Other modes:[JIS-Repair, Delete ESC, Force Delete ESC,
  258.              Hankaku to Zenkaku(To Full Size), Check Code Only]
  259.      • New algorithms which came with jconv ver.3.0.
  260.        [BTW, jconv 3.0 is available from info-mac archive 
  261.        in the util directory if I remember correctly. ]
  262. 1.4b1    The third release [1993.09.07]. 
  263.    • Disabled the progress bar for the smaller files (<5K).
  264.    • Disabled the "smooth" progress bar for the larger files.
  265.       These are for the sake of speed.
  266.    • Added behavior control mode, i.e., preference setting for 
  267.       default behavior of JCONV-DD.
  268.    • Added a modifier key to specify New-JIS for output to 
  269.       override the user setting.
  270.  
  271. 1.4b2    The Second evolution of version 1.4. 
  272.    • Changed the specification so that it will truncate the 
  273.      filename of the output when it is too long, so that now 
  274.      it works even for a very long file name. 
  275.  
  276. 1.4b3    The Third evolution of version 1.4. [1993.09.25]
  277.    • Fixed a bug which caused a crash in System7.0.1 when 
  278.      using in Command or preference mode. 
  279.  
  280. 1.4b5    [1993.10.18]
  281.    • Fixed a bug which did not allow it to process more 
  282.      than 7 files at a time.
  283.  
  284. 1.5.0    [1993.10.30]
  285.    • Changed the default behavior control dialog so that it is
  286.      now possible to change the default behavior according to 
  287.      the code of the input file. 
  288.  
  289. 1.6.0    [1993.12.26]
  290.    • Now it allows the selection of the EOL characters 
  291.      depending upon the input file's encoding scheme. 
  292.       
  293. 1.6.1    [1993.12.29]
  294.    • Fixed the bugs caused the euc conversion fail and 
  295.      the file creator not properly set in Repair JIS 
  296.      mode. Also fixed the bug which caused the command 
  297.      mode to be ineffective. The Japanese document had 
  298.      fixed some typos. 
  299.  
  300. 1.6.2    [1994.02.21]
  301.    • Now creates a unique file name so that it will not 
  302.      collide with the existing files. 
  303.    • Support of Balloon help for preference dialog and 
  304.      the finder icon are added. 
  305.      
  306. 1.6.3    [1994.03.27]
  307.    • Fixed the bug which caused the loss of ascii 
  308.      characters in SJIS->SJIS conversion. 
  309.    • Added a check box in the prefs dialog to allow 
  310.      choice between ESC(B and ESC(J in the output 
  311.      New & Old JIS file. 
  312.    • Added a check box in the prefs dialog to allow 
  313.      choice between new file generation or in place  
  314.      conversion. 
  315.    • Changed the finder help balloon to use styled text. 
  316.    • Fixed the bug so that now the progress bar is 
  317.      displayed properly on a B/W monitor. 
  318.  
  319. 1.7.0     [1994.04.24]
  320.    • Now help balloons are displayed properly within the 
  321.      preference dialogue box. 
  322.    • Preference dialogue box became accessible from the 
  323.      File menu, too. 
  324.    • Setting the creator for the output file can now be 
  325.      done through the standard file dialogue. 
  326.      
  327. 1.7.1     [1994.04.28]
  328.    • Improved the Kanji Code detection algorithm so that 
  329.      dection of EUC and SJIS Hankaku Kana became better.
  330.  
  331. 1.7.3    [1994.04.30]
  332.    • Fixed the bug which caused an infinite-loop when 
  333.      folder is dropped without specifying the in-place 
  334.      conversion option. (1.7.3)
  335.    • Fixed the bug in the preference dialogue. 
  336. 1.8      [1994.06.16]
  337.    • Unified the features of CRLF. Now you can deal with 
  338.      ASCII text and broken JIS text alike.  
  339. 1.8.1    [1994.12.04]
  340.    • Became FAT Binary. 
  341.      
  342. Future Directions:
  343. ------------------
  344. In version 2.0, multiple Kanji codes in a single input 
  345. file will be supported. 
  346.  
  347. I am thinking of adding the following capabilities in the 
  348. future:
  349.  
  350. 1) Resource folk preservation. 
  351. 2) CIS JIS support. 
  352.  
  353. Miscellaneous:
  354. --------------
  355.    As a default, JCONV-DD accepts only the text files 
  356.    and Folders. However, you can change this behavior 
  357.    by fiddling with ResEdit. Open a BNDL resource 128 
  358.    and add a new file type. Then, drop it on a utility 
  359.    like Save-a-BNDL or rebuild the desktop. This would 
  360.    do the trick. Note that JCONV-DD will through away 
  361.    all the resource fork. Do this only with caution 
  362.    and if you are absolutely sure on what you are doing. 
  363.    
  364.    There are several icons supplied since ver.1.6. 
  365.    If you set the creator CRLF, then crlf icon will 
  366.    appear even if you don't have CRLF. (You may need 
  367.    to rebuild the desktop.) 
  368.    If you set the creator JCNV, then JIS file icon 
  369.    will appear. 
  370.    You can browse through the icon resources by ResEdit 
  371.    to see more icons supplied with JCONV-DD.
  372.  
  373. Other utilities from the same author
  374. ------------------------------------
  375. CRLF : Converts file format among UNIX<->Mac<->IBM (well, more 
  376.        formally, changes the end of line character among 
  377.        LF<->CR<->CRLF) on Drag & Drop. It converts the file 
  378.        "in place", i.e., it does not create a new file with another 
  379.        extension. Instead of the extension, you will be able to 
  380.        figure out the file's format by the icon.
  381.        
  382.        It does not break up the Japanese code like 
  383.        some other similar utility does. You can set up the 
  384.        default behavior just like JCONV-DD, so you would not need 
  385.        the interaction after then. 
  386.        
  387.        Written in Think C ver.6.0. 
  388.        [DonateWare] 
  389.        
  390. Rescue George : A puzzle
  391.  
  392. <End of ReadMe>